home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 46 / Amiga Format CD46 (1999-10-20)(Future Publishing)(GB)[!][issue 1999-12].iso / -in_the_mag- / reader_requests / scilab / man / man-part2 / cat5 / scicos.5 < prev    next >
Text File  |  1999-09-16  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. scicos(5)                        Scicos GUI                        scicos(5)
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11. NAME
  12.   scicos - Block diagram editor and GUI to hybrid simulator scicosim
  13.  
  14. CALLING SEQUENCE
  15.   sys=scicos([sys])
  16.  
  17. PARAMETERS
  18.   sys  : a Scicos data structure
  19.  
  20. DESCRIPTION
  21.   scicos is a visual editor for constructing models of hybrid dynamical sys-
  22.   tems. Invoking scicos with no argument opens up an empty scicos window.
  23.   Models can then be assembled, loaded, saved, compiled, simulated, using GUI
  24.   of scicos. The input and ouput arguments are only useful for debugging pur-
  25.   poses. scicos serves as an interface to the various block diagram compilers
  26.   and the hybrid simulator scicosim.  Here is a list of operations available
  27.   in scicos:
  28.   Help :   To get help on an object or menu buttons,
  29.                 click first on Help button and then on          the selected
  30.        object or menu item.
  31.   Edit :   Click on the Edit button to open the Edit menu.
  32.  
  33.   Simulate..
  34.        :   Click on the Simulate.. button to open the
  35.                 compilation/execution menu.
  36.  
  37.   File..
  38.        :   Click on the File.. button to open the file management menu.
  39.  
  40.   View :   To shift the diagram to left, right, up or down,
  41.               click first on the View button, then on a point in
  42.               the diagram where you want to appear in the middle
  43.               of the graphics window.
  44.  
  45.   Exit :   Click on the Exit button to leave scicos and
  46.                 return to Scilab session. Save your diagram          before
  47.        leaving Scicos or it will be lost.
  48.  
  49.   Palettes
  50.        :   Click on the Palettes button to open a new palette.
  51.  
  52.   Move :   To move a block in main Scicos window,
  53.                 click first on the Move button, then          click on the
  54.        selected block, drag the          mouse to the desired new block posi-
  55.        tion and          click again to fix the position.           The lower
  56.        left corner of the block is placed          at the selected point.
  57.  
  58.   Copy :   To copy a block in main Scicos window
  59.                  Click first on the Copy button, then           click on the
  60.        to-be-copied block (in           Scicos window or in a palette) ,  and
  61.                  finally click where you want the copy           to be placed
  62.        in the Scicos window.            The lower left corner of the block is
  63.        placed           at the selected point.
  64.   Align
  65.        :   To obtain nice diagrams, you can align ports of
  66.                 different blocks, vertically and horizontally.
  67.        Click first on the Align button, then on the first          port and
  68.        finally on the second port.           The block corresponding to the
  69.        second port is moved.           A connected block cannot be aligned.
  70.  
  71.   Link :   To connect an output port to an input port,
  72.                 click first on the Link button, then on the output
  73.        port and finally on the input port.           To split a link, click
  74.        first on the Link button,          then on the link where the split
  75.        should be placed,          and finally on an input port.
  76.        Only one link can go from and to a port.           Link color can be
  77.        changed directly by clicking          on the link.
  78.  
  79.   Delete
  80.        :   To delete a block or a link, click first on the Delete
  81.                 button, then on the selected object.           If you delete
  82.        a block all links connected to it          are deleted as well.
  83.  
  84.   Flip :     To reverse the positions of the (regular) inputs            and
  85.        outputs of a block placed on its sides,            click on the Flip
  86.        button first and then on the            selected block. This does not
  87.        affect the order,            nor the position of the input and output
  88.        event            ports which are numbered from left to right.
  89.                   A connected block cannot be flipped.
  90.  
  91.   Undo :   Click on the Undo button to undo the last edit operation.
  92.  
  93.   Replot
  94.        :   Click on the Replot button to replot the content of
  95.                 the graphics window. Graphics window stores complete
  96.        history of the editing session in memory.                    Replot is
  97.        usefull for cleaning this memory.
  98.   Back :   Click on the Back button to go back to the main menu.
  99.  
  100.   Compile
  101.        :   Click on the Compile button to compile the block diagram.
  102.                 This button need never be used since compilation is
  103.        performed automatically, if necessary, before          the beginning
  104.        of every simulation (Run button).                    Normally, a new
  105.        compilation is not needed if only          system parameters and
  106.        internal states are modified.
  107.                 In some cases howeever modifications are not
  108.        correctly updated and a manual compilation may be          needed
  109.        before a Restart or a Continue.           Please report if you
  110.        encounter such a case.
  111.  
  112.   Run  :   Click on the Run button to start the simulation.
  113.                 If the system has already been simulated, a          dialog
  114.        box appears where you can choose to Continue,
  115.                 Restart or End the simulation.
  116.  
  117.                 You may interrupt the simulation by clicking on the
  118.        ""stop"" button, change any of the block parameters          and con-
  119.        tinue the simulation with the new values.
  120.  
  121.   Save :    Click on the save button to save the block diagram
  122.                  in a binary file already selected by a previous
  123.        click on the Save As button. If you click on this           button and
  124.        you have never clicked on the Save As           button, the diagram is
  125.        saved in the current direcotry           as <window_name>.cos where
  126.        <window_name> is the name           of the window appearing on top of
  127.        the window (usually           Untitled or Super Block).
  128.  
  129.   Save As
  130.        :   Click on the Save As button to save the block diagram
  131.                  in a binary file. A dialog box allows choosing the
  132.        file which must have a .cos extension. The diagram           takes the
  133.        name of the file (without the extension).
  134.  
  135.   FSave
  136.        :    Click on the FSave button to save the diagram
  137.                  in a formatted ascii file. A dialog box allows
  138.        choosing the file which must have a .cosf extension.
  139.                  Formatted save is slower than regular save but           has
  140.        the advantage that the generated file is           system independent
  141.        (usefull for exchanging data           on different computers.
  142.  
  143.   Newblkn
  144.        :    Click on the Newblk button to save the Super Block
  145.                  as a new Scicos block. A Scilab function is generated
  146.                  and saved in a file <window_name>.sci in a user
  147.        palette directory. <window_name> is the name of the           Super
  148.        Block appearing on top of the window.            A dialog allows
  149.        choosing the palette directory.            To make Scicos recognize
  150.        your palettes, you should           define the Scilab variable
  151.        user_pal_dir as a column           vector of strings containing the
  152.        paths to your           palette directories. This can, for example, be
  153.        done           in your .scilab (user initialization) file.
  154.        You should also make sure the functions included in           your
  155.        palettes exists in Scilab environment before           using Scicos
  156.        (lib or getf).
  157.  
  158.   Load :   Click on the Load button to load an ascii or binary file
  159.                 containing a saved block diagram.  A dialog box allows
  160.                 choosing the file.
  161.  
  162.  
  163.   Setup
  164.        :   In the main Scicos window, clicking on the Setup button
  165.                 invokes a dialog box that allows you to change window
  166.                 dimensions, integration parameters: absolute and
  167.        relative error tolerances and the time tolerance          (the smal-
  168.        lest time interval for which the ode          solver is used to update
  169.        continuous states), and
  170.                 the simulation mode (1 or 2).           In a Super Block win-
  171.        dow, clicking on this button
  172.                 invokes a dialog box that allows changing the window
  173.        name (Super Block name) and window dimensions.
  174.  
  175.   New  :   Clicking on the New button loads an empty diagram in the
  176.                 main Scicos window. If the previous content of the
  177.        window is not saved, it will be lost.
  178.  
  179. SEE ALSO
  180.   scicosim
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.